Skip to content

Added ADRs 008, 009 #253

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 7 commits into from
Jul 1, 2025
Merged

Added ADRs 008, 009 #253

merged 7 commits into from
Jul 1, 2025

Conversation

tuj
Copy link
Contributor

@tuj tuj commented Jun 30, 2025

Link to issue

#249

Link to ticket

https://leantime.itkdev.dk/#/tickets/showTicket/4565

Description

  • Added ADR 008 - Improved developer experience
  • Added ADR 009 - Remove remote components

@tuj tuj added this to the 3.0.0 milestone Jun 30, 2025
@tuj tuj requested a review from turegjorup June 30, 2025 13:49
@tuj tuj self-assigned this Jun 30, 2025
@tuj tuj added the enhancement New feature or request label Jun 30, 2025
@tuj tuj mentioned this pull request Jun 30, 2025
34 tasks
@@ -0,0 +1,35 @@
# ADR 008 - Improved developer experience
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The title (and file name)should reflect the technical decision. "Improved developer experience" is the context, the decision is "mono-repo", or "use single repository"


## Context

When a new feature is added to the system, it often depends on changes to multiple repositories, at the same time.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

With the current multi-repository setup, when a new feature ....

When a new feature is added to the system, it often depends on changes to multiple repositories, at the same time.
This split across the repositories complicates the development process.

Another part of this is the maintenance of the repositories. It is important that the code uses up-to-date
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Another part of this is dependency management and maintenance across multiple repositories. It is important ...


## Decision

We gather the different repositories of the OS2Display project into one repository (the API repository) and
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We gather the code in os2display/display-api-service repository. The os2display/display-client, os2display/display-admin-client and os2display/display-templates repositories will be merged into os2display/display-api-service.

The os2display/display-api-servicerepository will be renamed to os2display/display

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The os2display/display-docs repository will be kept separate to avoid coupling usage updates to releases.

We gather the different repositories of the OS2Display project into one repository (the API repository) and
rename it from os2display/display-api-service to os2display/display.

Symfony will handle the routes for the admin and client.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Given our misunderstanding when discussing this, this should be clarified further:

Symfony routes and controllers will be added for /client and /admin to handle serving and configuring the screen and admin clients. This will enable us to move config for the two clients to env and expose directly in html through twig templates.

The static build javascript files will be served directly by nginx from /public

## Decision

We remove the option of loading external templates into the system (remote components) and
replacing it with templates that are a part of the code.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
replacing it with templates that are a part of the code.
replace it with templates that are a part of the code. The `os2display/display-templates` will be merged with the `os2display/display-api-service` repository (See ADR-008)

@tuj tuj changed the title 4565: Added ADRs 008, 009 Added ADRs 008, 009 Jun 30, 2025
@tuj tuj requested a review from turegjorup June 30, 2025 21:51
Copy link
Contributor

@turegjorup turegjorup left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Minor updates to my own changes 🙄

@tuj tuj merged commit 99abe14 into release/3.0.0 Jul 1, 2025
12 of 13 checks passed
@tuj tuj deleted the feature/4565-adr branch July 1, 2025 07:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants